GtkSearchBar: Mention we don't handle Ctrl+F for the app

There's probably an expectation from the app developers that
Ctrl+F or similar common shortcuts for starting a search will
be handled by the widget, when this is not the case. Explicitely
mention it in the docs to avoid confusion.

https://bugzilla.gnome.org/show_bug.cgi?id=701523

diff --git a/gtk/gtksearchbar.c b/gtk/gtksearchbar.c
index db0c5545d37ed27eaba7542e215e2f401d884637..c45b3c54ccbb1b113c6f53a1b358e3afdbe419cd 100644 (file)
--- a/gtk/gtksearchbar.c
+++ b/gtk/gtksearchbar.c
@@ -47,7 +47,8 @@
  *
  * For keyboard presses to start a search, events will need to be forwarded
  * from the top-level window that contains the search bar. See
- * gtk_search_bar_handle_event() for example code.
+ * gtk_search_bar_handle_event() for example code. Common shortcuts such as Ctrl+F
+ * should be handled as an application action, or through the menu items.
  *
  * You will also need to tell the search bar about which entry you are
  * using as your search entry using gtk_search_bar_connect_entry().